home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / OpenGL-ftn / fglprioritizetexturesext.z / fglprioritizetexturesext
Encoding:
Text File  |  2002-10-03  |  7.3 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ffffggggllllPPPPrrrriiiioooorrrriiiittttiiiizzzzeeeeTTTTeeeexxxxttttuuuurrrreeeessssEEEEXXXXTTTT((((3333GGGG))))   OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee   ffffggggllllPPPPrrrriiiioooorrrriiiittttiiiizzzzeeeeTTTTeeeexxxxttttuuuurrrreeeessssEEEEXXXXTTTT((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ffffggggllllPPPPrrrriiiioooorrrriiiittttiiiizzzzeeeeTTTTeeeexxxxttttuuuurrrreeeessssEEEEXXXXTTTT - set texture residence priority
  10.  
  11.  
  12. FFFFOOOORRRRTTTTRRRRAAAANNNN SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      SUBROUTINE ffffggggllllPPPPrrrriiiioooorrrriiiittttiiiizzzzeeeeTTTTeeeexxxxttttuuuurrrreeeessssEEEEXXXXTTTT( INTEGER*4 _n,
  14.                                           CHARACTER*8 _t_e_x_t_u_r_e_s,
  15.                                           CHARACTER*8 _p_r_i_o_r_i_t_i_e_s )
  16.  
  17.  
  18. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  19.      _n           The number of textures to be prioritized.
  20.  
  21.      _t_e_x_t_u_r_e_s    An array containing the names of the textures to be
  22.                  prioritized.
  23.  
  24.      _p_r_i_o_r_i_t_i_e_s  An array containing the texture priorities.  A priority given
  25.                  in an element of _p_r_i_o_r_i_t_i_e_s applies to the texture named by
  26.                  the corresponding element of _t_e_x_t_u_r_e_s.
  27.  
  28. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  29.      ffffggggllllPPPPrrrriiiioooorrrriiiittttiiiizzzzeeeeTTTTeeeexxxxttttuuuurrrreeeessssEEEEXXXXTTTT assigns the _n texture priorities given in
  30.      _p_r_i_o_r_i_t_i_e_s to the _n textures named in _t_e_x_t_u_r_e_s.
  31.  
  32.      On machines with a limited amount of texture memory, OpenGL establishes a
  33.      ``working set'' of textures that are resident in texture memory.  These
  34.      textures may be bound to a texture target much more efficiently than
  35.      textures that are not resident.  By specifying a priority for each
  36.      texture, ffffggggllllPPPPrrrriiiioooorrrriiiittttiiiizzzzeeeeTTTTeeeexxxxttttuuuurrrreeeessssEEEEXXXXTTTT allows applications to guide the OpenGL
  37.      implementation in determining which textures should be resident.
  38.  
  39.      The priorities given in _p_r_i_o_r_i_t_i_e_s are clamped to the range [0.0, 1.0]
  40.      before being assigned.  Zero indicates the lowest priority, and hence
  41.      textures with priority zero are least likely to be resident.  One
  42.      indicates the highest priority, and hence textures with priority one are
  43.      most likely to be resident.  However, textures are not guaranteed to be
  44.      resident until they are bound.
  45.  
  46.      ffffggggllllPPPPrrrriiiioooorrrriiiittttiiiizzzzeeeeTTTTeeeexxxxttttuuuurrrreeeessssEEEEXXXXTTTT silently ignores attempts to prioritize texture
  47.      zero, or any texture name that does not correspond to an existing
  48.      texture.
  49.  
  50.      ffffggggllllPPPPrrrriiiioooorrrriiiittttiiiizzzzeeeeTTTTeeeexxxxttttuuuurrrreeeessssEEEEXXXXTTTT does not require that any of the textures named
  51.      by _t_e_x_t_u_r_e_s be bound to a texture target.  ffffggggllllTTTTeeeexxxxPPPPaaaarrrraaaammmmeeeetttteeeerrrr may also be
  52.      used to set a texture's priority, but only if the texture is currently
  53.      bound.  This is the only way to set the priority of a default texture.
  54.  
  55.      ffffggggllllPPPPrrrriiiioooorrrriiiittttiiiizzzzeeeeTTTTeeeexxxxttttuuuurrrreeeessssEEEEXXXXTTTT is included in display lists.
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ffffggggllllPPPPrrrriiiioooorrrriiiittttiiiizzzzeeeeTTTTeeeexxxxttttuuuurrrreeeessssEEEEXXXXTTTT((((3333GGGG))))   OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee   ffffggggllllPPPPrrrriiiioooorrrriiiittttiiiizzzzeeeeTTTTeeeexxxxttttuuuurrrreeeessssEEEEXXXXTTTT((((3333GGGG))))
  71.  
  72.  
  73.  
  74. NOTES
  75.      ffffggggllllPPPPrrrriiiioooorrrriiiittttiiiizzzzeeeeTTTTeeeexxxxttttuuuurrrreeeessssEEEEXXXXTTTT is part of the EEEEXXXXTTTT____tttteeeexxxxttttuuuurrrreeee____oooobbbbjjjjeeeecccctttt extension.
  76.      See ffffggggllllIIIInnnnttttrrrroooo for more information about using extensions.
  77.  
  78. EEEERRRRRRRROOOORRRRSSSS
  79.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _n is negative.
  80.  
  81.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ffffggggllllPPPPrrrriiiioooorrrriiiittttiiiizzzzeeeeTTTTeeeexxxxttttuuuurrrreeeessssEEEEXXXXTTTT is executed
  82.      between the execution of ffffggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of
  83.      ffffggggllllEEEEnnnndddd.
  84.  
  85. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  86.      ffffggggllllGGGGeeeettttTTTTeeeexxxxPPPPaaaarrrraaaammmmeeeetttteeeerrrr with parameter name GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____PPPPRRRRIIIIOOOORRRRIIIITTTTYYYY____EEEEXXXXTTTT retrieves
  87.      the priority of a currently-bound texture.
  88.  
  89.  
  90. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  91.      ffffggggllllAAAArrrreeeeTTTTeeeexxxxttttuuuurrrreeeessssRRRReeeessssiiiiddddeeeennnnttttEEEEXXXXTTTT, ffffggggllllBBBBiiiinnnnddddTTTTeeeexxxxttttuuuurrrreeeeEEEEXXXXTTTT, ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD,
  92.      ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD, ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDDEEEEXXXXTTTT, ffffggggllllTTTTeeeexxxxPPPPaaaarrrraaaammmmeeeetttteeeerrrr.
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.